onUpdate

Доступность

Flash Player 6.

Синтаксис

function onUpdate() {
   ...statements...;
}

Параметры

Нет.

Возвращает

Ничего.

Описание

Обработчик события; onUpdate используется Live Preview компонента.Когда у экземпляра компонента на Сцене имеется Live Preview, среда разработки вызывает функцию onUpdate, когда какой-либо из параметров компонента изменяется. Функция onUpdate вызывается средой разработки без параметров и возвращаемое ей значение игнорируется. Функция onUpdate должна объявляться на главном Таймлайне Live Preview.

Определение функции onUpdate для Live Preview является необязательным.

Для более подробной информации о Live Preview, смотри Использование Компонентов.

Пример

Функция onUpdate дает Live Preview возможность менять внешний вид в зависимости от значений параметров компонента. Когда пользователь изменяет значения параметров на панели Свойство inspector или закладке Parameters панели Components inspector, вызывается функция onUpdate. Функция onUpdate выполняет какие-либо действия для отражения изменений. Допустим, если у компонента есть параметр color, функция onUpdate может изменять цвет мувиклипа внутри Live Preview компонента, чтобы пользователь мог увидеть внешний вид компонента при новых значениях параметров. К тому же, функция может сохранять значение цвета во внешней переменной.

В следующем примере функция onUpdate используется для передачи параметров через пустой мувиклип в Live Preview. Чтобы увидеть, как этот код работает, поместите на Сцену компонент-кнопку и создайте переменную labelColor, чье значение будет определяеть цвет надписи на кнопке. Следующий код необходимо ввести в первый кадр компонента:

/* Определяем значение параметра textColor.*/
buttonLabel.textColor = labelColor;

В Live Preview разместите пустой мувиклип xch. Затем разместите данный код в первом кадре Live Preview. Добавьте "xch" к пути переменной labelColor для передачи значения через my_mc movie clip:

// Описываем функцию onUpdate, добавляя "my_mc." к именам переменных:
function onUpdate (){
  buttonLabel.textColor = my_mc.labelColor;
}

Смотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление